/**
 * Copyright 2007-2008 Vidar Svansson
 *     
 * This file is part of JAdapter.
 * 
 * JAdapter is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 * 
 * JAdapter is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with JAdapter.  If not, see <http://www.gnu.org/licenses/>.
 */
package org.jadapter.weavers;

/**
 * An AOP style weaver.
 * <br></br><br></br>
 * A weaver can be used as an alternative to injecting a 
 * {@link org.jadapter.registry.TransformerRegistry} instance into clients. 
 * Instead, the objects that are subject to transformations can be weaved with the registry.
 * This enables transparent usage of the registry through proxied objects.
 * 
 * 
 * 
 * @author Vidar Svansson
 * @since 0.2
 */
public interface Weaver {
    
	/** return a proxy of type T or return t directly.
	 * 
	 * @since 0.2
	 * @param <T> the type of the objects
	 * @param object the object to weave 
	 * @return the object back, either proxied or not
	 */
    public <T> T weave(T object);

}
